.TH std::basic_spanbuf::span 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::basic_spanbuf::span \- std::basic_spanbuf::span

.SH Synopsis
   std::span<CharT> span() const noexcept;   \fB(1)\fP (since C++23)
   void span( std::span<CharT> s ) noexcept; \fB(2)\fP (since C++23)

   1) Gets a span referencing the written area if std::ios_base::out is set in the open
   mode, or a span referencing the underlying buffer otherwise.
   2) Makes the basic_spanbuf perform I/O on the buffer referenced by s. Sets pointers
   to get area, put area, or both.

           Set bits in open mode                   Return value after setting
     (affecting pointers to get area)    eback()  gptr()             egptr()
   std::ios_base::in                     s.data() s.data()           s.data() +
                                                                     s.size()
           Set bits in open mode                   Return value after setting
     (affecting pointers to put area)    pbase()  pptr()             epptr()
   std::ios_base::out &&                 s.data() s.data()           s.data() +
   !std::ios_base::ate                                               s.size()
   std::ios_base::out &&                 s.data() s.data() +         s.data() +
   std::ios_base::ate                             s.size()           s.size()

.SH Parameters

   s - a std::span that references the user-provided buffer

.SH Return value

   1) std::span<CharT>(pbase(), pptr()) if std::ios_base::out is set in the open mode,
   or a std::span<CharT> that references the whole underlying buffer otherwise.
   2) \fI(none)\fP

.SH Example

    This section is incomplete
    Reason: no example

.SH See also

           replaces or obtains a copy of the associated character string
   str     \fI(public member function of std::basic_stringbuf<CharT,Traits,Allocator>)\fP

   view    obtains a view over the underlying character sequence
   (C++20) \fI(public member function of std::basic_stringbuf<CharT,Traits,Allocator>)\fP

           marks the buffer frozen and returns the beginning pointer of the input
   str     sequence
           \fI(public member function of std::strstreambuf)\fP

.SH Category:
     * Todo no example
